Partager via


Manage orders - Gets a product promotion by id.

Obtient les détails de la promotion par ID.

GET https://api.partnercenter.microsoft.com/v{version}/productpromotions/{id}
GET https://api.partnercenter.microsoft.com/v{version}/productpromotions/{id}?country={country}

Paramètres URI

Nom Dans Obligatoire Type Description
id
path True

string

ID de promotion.

version
path True

string

country
query

string

Code du pays.

En-tête de la demande

Nom Obligatoire Type Description
Authorization True

string

Jeton du porteur d’autorisation

ms-correlationid

string

Utilisé pour le suivi des demandes en interne. Si un ms-correlationid n’est pas fourni, le serveur en génère un nouveau pour chaque requête

MS-CV

string

Utilisé pour le suivi des demandes en interne. Si un MS-CV n’est pas fourni, le serveur en génère un nouveau pour chaque requête

ms-requestid

string

Utilisé pour l’idempotency des requêtes. Si un ms-requestid n’est pas fourni, le serveur en génère un nouveau pour chaque requête

Réponses

Nom Type Description
200 OK

Contracts.V1.Models.ProductPromotion

La demande a réussi. Le corps de la réponse contient les détails de la promotion.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

400 Bad Request

Une entrée est manquante ou non valide. Le corps de la réponse fournit les détails de l’erreur.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

401 Unauthorized

La demande n’a pas été authentifiée. Le client doit d’abord s’authentifier auprès du service d’API partenaire.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

403 Forbidden

La demande a été authentifiée, mais a été refusée, car l’appelant n’a pas les droits de l’appeler.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

404 Not Found

La ressource est introuvable ou non disponible avec les paramètres d’entrée donnés.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

500 Internal Server Error

Le service d’API partenaire ou l’une de ses dépendances n’a pas pu répondre à la demande.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

Définitions

Nom Description
Contracts.V1.Models.ProductPromotion
Contracts.V1.Models.ProductPromotionPricingPolicy
Contracts.V1.Models.ProductPromotionProperties
Contracts.V1.Models.ProductPromotionRequiredProduct
Contracts.V1.Models.ProductPromotionTerm

Contracts.V1.Models.ProductPromotion

Nom Type Description
description

string

endDate

string (date-time)

id

string

name

string

properties

Contracts.V1.Models.ProductPromotionProperties

requiredProducts

Contracts.V1.Models.ProductPromotionRequiredProduct[]

startDate

string (date-time)

Contracts.V1.Models.ProductPromotionPricingPolicy

Nom Type Description
policyType

string

value

string

Contracts.V1.Models.ProductPromotionProperties

Nom Type Description
isAutoApplicable

boolean

Contracts.V1.Models.ProductPromotionRequiredProduct

Nom Type Description
pricingPolicies

Contracts.V1.Models.ProductPromotionPricingPolicy[]

productId

string

skuId

string

term

Contracts.V1.Models.ProductPromotionTerm

Contracts.V1.Models.ProductPromotionTerm

Nom Type Description
billingCycle

string

duration

string